home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / spitfire / sfcvs11b.zip / EDITCFG.DOC < prev    next >
Text File  |  1996-04-06  |  6KB  |  183 lines
  1. Supplemental Documentation For SFCVS!
  2.  
  3. EDITCFG.EXE
  4.  
  5. ■ Introduction ■
  6.  
  7. EDITCFG is a companion utility to be used with SFCVS (Spitfire Caller
  8. Validation System). Its primary functions are to assist you in configuring
  9. SFCVS to run on your SPITFIRE BBS as well as help you create and maintain
  10. the PHONE.DAT file which is the data file SFCVS uses to determine a callers
  11. eligibility for an access upgrade.
  12.  
  13. ■ Usage ■
  14.  
  15. EDITCFG relies on an environmental variable which allows it to find your
  16. Spitfire Data Files.. This variable is used by utilities written by Mike
  17. Woltz and other programmers, therefore I am not asking you to add anything
  18. special just for SFCVS.. The variable you need to add is SFPATH. To check
  19. to see if you have this variable look in your AUTOEXEC.BAT file for this
  20. line:
  21.  
  22. SET SFPATH=DRIVE:\PATH TO SPITFIRE
  23.  
  24. If Your Spitfire Home Directory is C:\SF
  25.  
  26. Then
  27.  
  28. SET SFPATH=C:\SF
  29.  
  30. If this variable is there you are ok, if not add it and then reboot..:)
  31.  
  32. This variable will allow EDITCFG to find your Spitfire Data files no matter
  33. which drive and/or directory you execute EDITCFG from.
  34.  
  35. If you are executing EDITCFG.EXE for the first time, you will be prompted
  36. to create a config file needed by SFCVS.
  37.  
  38. Below is what EDITCFG's menu will look like:
  39.  
  40.  
  41.          ╓───────────────────────────────────────────────────────────╖
  42.          ║       Spitfire Caller Validation System Editor v1.2       ║
  43.          ║           (C) Copyright 1996 by Ross Cassell              ║
  44.          ║      The Dark Corner BBS (864)573-7069 SupraFax 28.8      ║
  45.          ╙───────────────────────────────────────────────────────────╜
  46.  
  47.                                 -■ MAIN MENU ■-
  48.  
  49. [I] Import Phone Numbers Into The Database
  50. [A] Manually Add Phone Numbers To The Database
  51. [V] View Numbers In The Database
  52. [E] Edit The Config File
  53.  
  54. Press Q Or Esc To Quit.
  55.  
  56. [ ] Select - I A V E Q Or Esc ?
  57.  
  58.  
  59. Commands Explained:
  60.  
  61.  
  62. [I] Import Phone Numbers Into The Database
  63.  
  64.     This command performs the actual physical import of phone numbers from
  65.     SFUSERS.DAT and BADNUM.CVS.
  66.  
  67.     See Bad Numbers
  68.     See Command Line Parameters
  69.     See Import Process
  70.  
  71. [A] Manually Add Phone Numbers To The Database
  72.  
  73.     This command is used to manually input phone numbers you determine to
  74.     be bogus, or belong to undesirable callers. The input number is written
  75.     to BADNUM.CVS, if BADNUM.CVS did not previously exist, it will get
  76.     created. If you inputted any numbers this way, EDITCFG will notify you
  77.     that it will automatically perform a import as described for command
  78.     [I]. No Automatic import will be performed if you aborted the ADD
  79.     process without saving any numbers.
  80.  
  81.     See Bad Numbers
  82.  
  83.  
  84. [V] View Numbers In The Database
  85.  
  86.     This command simply lets you view the phone numbers in the database at
  87.     any given time.
  88.  
  89.     See Command Line Parmeters
  90.  
  91. [E] Edit The Config File
  92.  
  93.     This command allows you to recreate your configuration file that is
  94.     used by SFCVS, in the event you changed information or whatever..
  95.  
  96. [ Bad Numbers ]
  97.  
  98. There are certain phone numbers which you may want to consider bogus or
  99. BAD. See the enclosed BADNUM.CVS text file for examples. These phone
  100. numbers would take into account phony numbers, numbers of undesirable
  101. callers, numbers of other local BBS systems, numbers of local fast food
  102. restaurants, the non-emergency numbers for local police/fire and rescue
  103. services etc.  There is no way you can acount for all possible numbers a
  104. new caller might try to use, but this helps. Anyway using EDITCFG or your
  105. favorite text editor, you can add bogus/bad numbers to BADNUM.CVS which
  106. later get imported into the main database. BADNUM.CVS is a simple ASCII
  107. text file and its format is simple, one number per line starting in column
  108. one:
  109.  
  110. ###-###-####
  111.  ^ ^ ^ ^  ^
  112.  | | | |  |____ Main Number
  113.  | | | |_______ Dash
  114.  | | |_________ Exchange
  115.  | |___________ Dash
  116.  |_____________ Area Code
  117.  
  118. Example
  119.  
  120. 123-555-1212
  121. 456-555-1212
  122. 789-555-1212
  123.  
  124. And so on...
  125.  
  126. If you manually add these numbers with a text editor, make sure to run a
  127. import so as to get these numbers included in PHONE.DAT. If adding them
  128. with EDITCFG, a import will automatically be run if any numbers were added.
  129.  
  130. [ Command Line Parameters ]
  131.  
  132. EDITCFG can accept 2 command line parameters:
  133.  
  134. EVENT
  135.  
  136. Allows you to perform the import unattended within a batch file, preferably
  137. you would do this after you have packed your SFUSERS.DAT file..
  138.  
  139. Ex:
  140.  
  141. EDITCFG EVENT
  142.  
  143. VIEW
  144.  
  145. Allows you to quickly go in and view your PHONE.DAT database. Works exactly
  146. the same way it would if done so from the menu interface, except that it
  147. exits to DOS after you have reached the end of the file. (Not for
  148. unattended operation)
  149.  
  150. Ex:
  151.  
  152. EDITCFG VIEW
  153.  
  154. [ Import Process ]
  155.  
  156. The import process is simple, when executed your existing PHONE.DAT file is
  157. deleted, If BADNUM.CVS exists, numbers listed within it are imported, then
  158. numbers listed in SFUSERS.DAT are imported... Keep in mind that EDITCFG
  159. will always import a bogus number of 123-456-7890 into PHONE.DAT, EDITCFG
  160. will also not import a phone number twice. no matter if it was in
  161. BADNUM.CVS or SFUSERS.DAT.
  162.  
  163. The purpose of the IMPORT process is to keep your PHONE.DAT as up to date
  164. as possible, this takes into consideration that if a good user got purged
  165. from SFUSERS.DAT, that their number wont remain in PHONE.DAT, as well as
  166. import into PHONE.DAT any numbers you have input into BADNUM.CVS.
  167.  
  168. Well, this explains the latest changes.....
  169.  
  170. See SFCVS.DOC, for credits and acknowledgements..
  171.  
  172. -Ross-
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.